This installation walkthrough based on personal machine through a virtualization tool. Because of the resource limitation, we will only create a single node.
Here is the material required for the installation.
1. Create a VM on Virtual Box:
Here are the details of the final settings of the vm. We will specifically talk about network setup in the next step.
2. Network Configuration: Below is my network setup. But this setup should work in most situation as long as your host computer can connect to a internet. NAT Network is for network traffic reaching to the internet and Host Only Network is for your host computer can access services in your VM from host machine.
For Mac user, first click VirtualBox -> Preferences -> Network. You will see pop up screen as below, and click Adds new NAT network.
Then double click on the new created NATNetwork. Please change your network CIDR to 10.20.0.0/24. This will be the private network block assigned to your vm. The default gateway will be the first ip of the CIDR block. For example gateway of network 10.20.0.0/24 will be 10.20.0.1.
Now we will set up another adapter. Go to File -> Host Network Manager. It will look something like below. First Create one and check enable DHCP Server [optional].
After done configuring the network adapter, be sure to add both adapter to your VM. No additional configuration required.
Be sure to load IIIDevOps-rke-v1.7.1-202108181553.iso image in your IDE Controller storage. You can safely start the virtual machine. This step will be seperated into two sections: linux system install and service deploy.
There are several steps involve but most of them should be the same.
ip (only configure nat adapter one’s): 10.20.0.70/24 (since we are using ip-domain name setup by iii in Google DNS 8.8.8.8, this ip is fixed)
gateway: 10.20.0.1 (this is virtualbox’s default for this CIDR and can not be changed)
name server: 8.8.8.8
partition disk: use entire disk and set up LVM just choose default for the subsequent questions
Install the grub boot loader on a hard disk: Yes
IIIDevops roles: ALL (This will configure this node to be both a master and worker)
hostname: Can be anything, easy to remember
base Service IP, K8s IP, NFS IP, NFS Shared Directory: All using default
version: standard
deployment mode: DNS (IP can also work)
Domain name settings: (If you choose DNS deployment mode)
IIIDevops (portal) super user: anything easy to remember
all service admin password and sudo password
After system installation, the system will reboot. Using rkeuser (sudo user) and password setting above to login and continue the application installation.
After login, we need to setup second network adapter (host-only) since during our previous system installation we can only set up one adapter (nat).
After installation one can check how the things work using following url:
If you choose DNS during installation:
If you choose IP during installation:
**Note Harbor is not able to use ip-port url when you have domain name configured. This may require further modification or feedback to iii.
Finally, the iiidevops portal is not up yet because it also requires pipeline setting up first which we will deal with in another documentation.